LD 137 


Issued: October 1997 
Status: Standard 


X11 Release: 23 





LD 137: Core Input/Output Diagnostic 


LD 137 provides IOP and CMDU related diagnostic and maintenance 
information for Option 11C, 51C, 61C, 81 and 81C machines with X11 
Release 18 and later. Some commands in LD 37 can also be used. Refer to 
that program. 


LD 137 provides a means of performing the following functions. 


— enabling and disabling the CMDU and IOP cards 

— displaying status and card ID for CMDU and IOP cards 

— testing the IOP and CMDU (the hard and floppy disk drives are tested) 
— testing individual disk drives 

— enabling and disabling disk redundancy 

— testing SCSI cable connections between IOPs and CMDUs 

— testing disk synchronization on file or sector levels 


— during midnight routines performs DATA CMDU, DATA RDUN 
commands 


— displaying the Security Device Identification of the Security Dongle 


The DATA CMDU AND DATA RDUN midnight routines are run every 5 
days. 
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When a status appears disabled, one or more Out of Service (OOS) messages 
may appear. Listed below are the possible OOS messages: 


e IOP out-of-service 

e Unexpected interrupt fault monitor threshold exceeded 

e Fault interrupt fault monitor threshold exceeded 

e Processor exception fault monitor threshold exceeded 

e ASIC interrupt fault monitor threshold exceeded 

e Unrecognized error fault monitor threshold exceeded 

e General event interrupt fault monitor threshold exceeded 
e IOP not responding 

e IOP disabled by craftsperson 

e IOP responding but cannot be enabled 

e CMDU out-of-service 

e Hard disk read error 

e Hard disk write error 

e Hard disk drive error 

e CMDU does not respond, the disk drive may be missing 
e CMDU has been disabled by the craftsperson 

e CMDU is disabled because the IOP is out-of-service 

e Hard disk is inaccessible 

e CMDUs are not synchronized 

e CMDU status is mismatched because of a software error 
e CMDU is in split mode 

e CMDU is out of split mode 

e No access to hard disk (HDK) 
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Basic Commands 


DATA CMDU n 


Perform read tests on the specified CMDU. 


DATA CMDU n HDK, FDK 


DATA RDUN 
DIS CMDU n 
DIS ELNK 
DIS IOP 


ENL CMDU n 
ENL ELNK 
ENL IOP 
ENL HOST n 


IDC 

IDC CMDU n 
IDC IOP 

SDID 

STAT 

STAT CMDU n 
STAT ELNK 


STAT HOST 
STAT IOP 


SWAP 
SYNC 


TEST CMDU n 


Perform read test on either the Hard Disk or Floppy Disk 
Perform sector level checking on both hard disk 

Disable CMDU. 

Disable the ethernet link on the active IOP pack 

Disable the active IOP and Ethernet 


Enable the CMDU. 

Enable the ethernet link on the active IOP pack 
Enable IOP on the active Core and Ethernet 
Add a host to run time host table 


Print the IDs of both CMDUs and the active IOP 
Print the ID for the CMDU 
Print out the ID of the active IOP 


Display Security Device Identification of Security Dongle(s) 


Get status of IOPs, CMDUs and Ethernet. 

Get status of the CMDU. 

Display status of the ethernet link on the active IOP pack whether enabled or 
disabled 

Display current run time host table status 

Display status of the active IOP and Ethernet 


Swap the CMDUs 
Synchronize the hard disks on both CMDUs 


Perform test for the CMDU. 


TEST CMDU n HDK, FDK 


Perform test on the Hard or Floppy Disk 


TEST ELNK INT Test internal loop-back on Ethernet link 
TEST ELNK EXT Test external loop-back on Ethernet link 
TEST ELNK TDR Test the Time Domain Reflectometry 


TEST IOP 
TEST RDUN 
TEST SCSI 


TTYx 


Perform the self test on the active IOP 
Perform file level checking on both hard disks 
Test the SCSI cables 


Test TTY x 
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Option 11C Commands 





Command Description 

DIS ELNK Disable ethernet link 

ENL ELNK Enable ethernet link 

STAT Get status of PPP and ethernet link 


STAT ELNK Display status of ethernet link 
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Alphabetical list of commands 


Command 


DATA CMDU n 


Description Pack/Rel 


Perform read tests on the specified CMDU. basic-18 


This data validity check is performed on both hard and floppy 
disks. While the test is in progress, the CMDU is inaccessible. 
Progress messages are output. n = core number (0 or 1) If nis 
not entered, this command checks both CMDUs. 


This is more extensive than the TEST command, and may take 
longer. 


DATA CMDU n HDK, FDK 


DATA RDUN 


DIS CMDU n 


Perform read test on either the Hard Disk or Floppy Disk. This is basic-18 
a data validity check. While the test is in progress, the Disk is 
inaccessible. 


Where: n = Core number (0 or 1). You must enter the Core 
number. This is more extensive than the TEST command, and 
may take longer. 


Perform sector level checking on both hard disks. basic-18 


This test ensures that disk synchronization (disk redundancy) 
exists. It can only be performed when disk redundancy is 
enabled. All data is checked, on both disks, sector by sector. If 
the test fails, a CIOD message appears, and disk redundancy is 
disabled. 


This is more extensive than the TEST command, and may take 
longer. While this test is in progress, the disks are inaccessible. 


Disable CMDU. Where: n = Core number (0 or 1). You must basic-18 
enter the Core number. 


If disk redundancy is currently enabled (both CMDUs are 
enabled and enabled), disabling the CMDU also disables disk 
redundancy. 

The confirmation is displayed: 


"CURRENTLY CMDU N IS ACTIVE. DISK RDUN WILL BE 
DISABLED. ENTER Y(ES) TO CONFIRM, N(O) TO ABORT." 





























If the specified CMDU is in standby, its state is changed to 
disabled. If it is the active CMDU, it is disabled, and the standby 
CMDU becomes active. 
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DIS ELNK Disable the ethernet link on the active IOP pack. basic-22 


An attempt is made to disable the Ethernet link. When the link is 
disabled, all activities will be terminated. The system displays OK 
to indicate that the link is disabled or FAIL to indicate that the 
link could not be disabled. 


DIS IOP Disable the active IOP and Ethernet. The LED is lit on the IOP. basic-18 
faceplate and both CMDUs are inaccessible. 

ENL CMDU n Enable the CMDU. basic-18 
Where: n = Core number (0 or 1). You must enter the Core 
number. 


When the first CMDU is enabled, that CMDU's state is ACTIVE. 


If a second ENL CMDU is attempted, a file level synchronization 
on both hard disks is performed first. If the synchronization (disk 
redundancy) does not exist, a CIOD error message is printed, 
and the second CMDU remains disabled. 


If the synchronization exists, the confirmation is displayed: 





"DISK RDUN WILL BE ENABLED, ENTER Y (ES) to CONFIRM, 
N(O) TO ABORT." 




















When disk redundancy is successful, both CMDU states are 
Enabled. The CMDU enabled first is active, and the second is 
standby. 


ENL ELNK Enable the ethernet link on the active IOP pack. basic-22 


If the Ethernet link is down, entering this command will cause an 
attempt to restore the Ethernet link to normal operation state. 
However, if the system cannot successfully restore the link, the 
Ethernet link will remain disabled. 


If the link was already up, this command does not affect the 
current operation of it. The system displays OK to indicate that 
the link is now enabled or FAIL to indicate that the link could not 
be enabled. 


ENL HOST n Add a host to run time host table. basic-22 
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IDC 


IDC CMDU n 


IDC IOP 


SDID 


STAT 
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Enable IOP and Ethernet on the active Core. basic-18 


The LED is turned off on the IOP faceplate. The CMDUs are 
restored to the state they were in prior to the IOP being 
changed. However, if the cable between the IOPs is not 
connected, the CMDUs remain inaccessible until the cable is 
reattached. 


If both CMDUs were enabled, a file level synchronization check 
is performed prior to restoring states. If the synchronization 
(disk redundancy) does not exist, only the previously active 
CMDU is enabled. 


Print the IDs of both CMDUs and the active IOP. The printout basic-18 
appears in the following format: 


PPppppppppp Lrrssss CCCCCCCC 
Where: 

* pppppppppp = PEC code 

e rr = Release number 


* ssss = Serial number 
* cccccccc = Comments (not always be present) 


Print the ID for the CMDU. Where: n = Core number (0 or 1). If + basic-18 
nis not entered, card ID information is printed for both CMDUs. 


Print out the ID of the active IOP. basic-18 
Display Security Device Identification of Security Dongle(s) basic-23 
Get status of IOPs, CMDUs and Ethernet. basic-18 


For the IOP, the Enabled or Disabled, and Active or Standby 
state is printed. Status is given for active and standby IOPs. For 
the CMDU, Disk redundancy, enabled/disabled, and 
active/standby status are printed. If Ethernet is disabled, the 
status (enabled or disabled) is displayed along with an OOS 
message. 


The status given for the standby IOP is a software status as it 
was last seen when that IOP was active. No hardware status is 
given because the standby IOP cannot be accessed. 


For Option 11C: The STAT command is used to get status of 
PPP and ELNK. 
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STAT CMDU n 


553-3001-511 


If the status of the IOP or CMDU is disabled, one of the following 


OOS messages may appear: 
e IOP out-of-service 


e Unexpected interrupt fault monitor threshold exceeded 


e Fault interrupt fault monitor threshold exceeded 


e Processor exception fault monitor threshold exceeded 


e ASIC interrupt fault monitor threshold exceeded 


e Unrecognized error fault monitor threshold exceeded 
e General event interrupt fault monitor threshold exceeded 


e IOP not responding 
e IOP disabled by craftsperson 


e IOP responding but cannot be enabled 
e CMDU out-of-service 


¢ Hard disk read error 
¢ Hard disk write error 
e Hard disk drive error 


e CMDU does not respond, the disk drive may be missing 


e CMDU has been disabled by the craftsperson 


e CMDU is disabled because the IOP is out-of-service 
e Hard disk is inaccessible: CMDUs are not synchronized 


e CMDU status is mismatched because of a software 


error 
e CMDU is in split mode 

e CMDU is out of split mode 

e No access to hard disk (HDK) 


Get status of the CMDU. Where: n = Core number (0 or 1). 


If n is not entered, the status for both CMDUs is printed. 


If the CMDU is disabled, one of the following CMDU OOS 


reason may appear: 
e Hard disk read error 
e Hard disk write error 
e Hard disk drive error 
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STAT ELNK 


STAT HOST 


STAT IOP 
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e CMDU does not respond, the disk drive may be missing 
e CMDU has been disabled by the craftsperson 

e CMDU is disabled because the IOP is out-of-service 

e Hard disk is inaccessible 

e CMDUs are not synchronized 


e CMDU status is mismatched because of a software 
error 


e CMDU is in split mode 
e CMDU is out of split mode 
e No access to hard disk (HDK) 


Display status of the ethernet link on the active IOP pack basic-22 
whether enabled or disabled. The Ethernet address of this 
active Input Output Processor (IOP) is also displayed. 


Since the Local Area Network Controller for Ethernet (LANCE) 
is equipped on the IOP, LANCE will be disabled when the IOP is 
disabled. 


If the ethernet link is disabled, an OOS reason will be displayed 
containing the following information: 





ELNK ENABLED 

Ethernet (In unit number 0): 

Host: aaaxxx 

Internet address: XX.XXX.XX.XXX 

Netmask: XXXXXXXXXX ; Subnetmask: XXXXXXXXXX 
xxx packets received ; xxx packets sent 

x input errors ; x output errors 

x collisions 














Display current run time host table status. basic-22 


Display status of the active IOP and Ethernet. basic-18 


This command prints out the status whether the IOP is enabled 
or disabled. If it is disabled, the OOS reasons are printed. The 
following IOP OOS messages may appear: 


e IOP out-of-service 

e Unexpected interrupt fault monitor threshold exceeded 
e Fault interrupt fault monitor threshold exceeded 

e Processor exception fault monitor threshold exceeded 
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e ASIC interrupt fault monitor threshold exceeded 

e Unrecognized error fault monitor threshold exceeded 

e General event interrupt fault monitor threshold exceeded 
e IOP not responding 

e IOP disabled by craftsperson 

« IOP responding but cannot be enabled 


SWAP Swap the CMDUs. basic-18 


After this command is issued, the active CMDU becomes 
standby, and the standby CMDU becomes active. This 
command is performed only when disk redundancy is enabled. 


SYNC Synchronize the hard disks on both CMDUs. basic-18 


This is a sector level synchronization. It is performed by copying 
the data from the active CMDU to the disabled CMDU, sector by 
sector. This can only be done when one CMDU is active and 
one is disabled. 


The confirmation prompt appears when the system is ready to 
do the copying: 





“CMDU n ACTIVE HDK WILL BE COPIED AND DISK RDUN 
WILL BE ENABLED. ENTER Y TO CONFIRM.” 
































Synchronization may take as long as 40 minutes. Progress 
reports appear on the TTY periodically. 


TEST CMDUn Perform test for the CMDU. basic-18 


This test includes a self-test, read/write capability test, and disk 
access test on both hard and floppy disks for this CMDU. While 
the test is in progress, the CMDU is inaccessible. 


Where: n = Core number (0 or 1). You must enter the Core 
number. 


A disk must be in the floppy drive when this test is run. If the 
floppy disk is not present, the floppy disk test will fail. The hard 
disk test will not be affected. 
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TEST CMDU n HDK, FDK basic-18 


TEST ELNK EXT 


TEST ELNK INT 


TEST ELNK TDR 


TEST IOP 


TEST RDUN 


Perform test on the Hard or Floppy Disk. 


This test includes a self-test, read/write capability test, and disk 
access test on either the hard or floppy disk drive for this CMDU. 
While the test is in progress, the CMDU is inaccessible. 


Where: n = Core number (0 or 1). You must enter the Core 
number. 


A disk must be in the floppy drive to test it. If a floppy disk is not 
present, the floppy disk test will fail. The hard disk test will not be 
affected. 


basic-22 
Test the external-loop back on Ethernet link. 


The result displayed can be either: PASS or FAIL. A pass 
indicates that the system can transmit its own transmitted 
packet and a fail means the opposite. 


basic-22 
Test the internal-loop back on Ethernet link. 


The result displayed can be either: PASS or FAIL. A pass 
indicates that the system can receive its own transmitted packet 
and a fail means the opposite. 


basic-22 
Test the Time Domain Reflectory 
The displayed result is used to determine the location of 
suspected cable faults. A confirm message is displayed to ask 
the user to enter YES or NO. The entry YES tells the system to 
stop the Ethernet communication and perform a DTR. The entry 
NO tells the system to ignore the command. 


The Ethernet link remains disabled after this test. The user must 
enable it by command ENL ELNK. 


Perform the self test on the active IOP and internal loop-back basic-18 
test on Ethernet. The IOP must be disabled to perform this test. 


Perform file level checking on both hard disks. basic-18 


This test ensures that disk synchronization exists. It can only be 
performed when disk redundancy is enabled. If the test fails, a 
CIOD message appears, and disk redundancy is disabled. 


While this test is in progress, the disk is inaccessible. 
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TEST SCSI 


TTY x 


Test t 


Alphabetical list of commands 


he SCSI cables. 


This test ensures the cable connections between the IOPs 
are present. Access to the CMDUs is t 


If the test is successful, OK is printed. If the test is unsuccessful, 


ested as well. 


CIOD messages are printed to indicate the problem. 


Test TTY x. Response is: 


ABCD] 





EFGHIJKLMNOPORSTUVWXYZ 


0123456789"#SS*!1&()<>-.:,.? RI 





EADY FOR INPUT 


Anything entered on the keyboard will be echoed until END is 


input. 


basic-18 


basic-18 
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